[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
SCRTEXT(IEXP1,IEXP2,IEXP3,BEXP) (STRING)
Function
Get text and attribute information directly from BBS screen memory.
Syntax
SCRTEXT(x,y,len,color)
x = An integer expression with the x coordinate (column) from which
to read screen memory.
y = An integer expression with the y coordinate (row) from which to
read screen memory.
len = An integer expression with the length, in columns, of the string
to read from screen memory.
color = A boolean expression with TRUE if color information should be
included, FALSE otherwise.
Return Type & Value
STRING
Returns the specified region of screen memory.
Remarks
This function is useful for temporarily saving a portion of screen
memory, with or without color information. If the color parameter is
set to TRUE color information will be included in the form of @X codes
embedded in the text. Note that the maximum length of a string is 256
characters; however, a row of 80 characters could be as long as 400
characters (4 bytes for the @X code and 1 byte for the character itself).
You should generally limit yourself to a length of 51 characters or less
if you want to include color information unless you are certain that
attribute changes will not exceed the 256 character string limit.
Examples
' scroll the screen to the left 5 columns and down 3 rows
INTEGER r
STRING s
FOR r = 20 TO 1 STEP -1
LET s = SCRTEXT(6,r,75,TRUE)
ANSIPOS 1,r+3
CLREOL
PRINT s
NEXT
FOR r = 1 TO 3
ANSIPOS 1,r
CLREOL
NEXT
See Also:
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson